home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / tbbs / ausrch10.zip / AUSEARCH.DOC next >
Text File  |  1996-05-19  |  7KB  |  253 lines
  1.  
  2.  
  3.  
  4.                               Advanced User Search
  5.                                       v1.0
  6.  
  7.                         (C)opyright 1996, Mark Jacobson
  8.      
  9.                                mark@pacifier.com  
  10.  
  11. ==========================================================================
  12.                        FEATURES OF ADVANCED USER SEARCH
  13. ==========================================================================
  14.  
  15. * Does not create bulky databases
  16. * Uses built in userlog.inx and userlog.bbs for maximum efficiency
  17. * Speedy User Search/List/Message Front end Utility            
  18. * Matches all users that contain a given search string
  19. * Allows leading space so users may search for last names
  20. * Lists results in alphabetical order by first name
  21. * Displays user name and user location fields
  22. * Does not display deleted users                                      
  23. * Allows users to pick from a list of matches to post messages
  24. * Tested thoroughly in ANSI and ASCII                                         
  25.  
  26.  
  27. NOTE: If you have need for a customized user utility, send me E-mail
  28. at mark@pacifier.com.  I can modify my code to get any information that
  29. you need from the USERLOG.BBS and output it to a text file, Data Base, or
  30. the screen.
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         i
  64.  
  65.  
  66. ==========================================================================
  67.                     WHAT IS ADVANCED USER SEARCH
  68. ==========================================================================
  69.  
  70.    Advanced User Search is a USER SEARCH/LIST/MAIL Front end Utility for
  71. eSoft's TBBS.  It utilizes directly the userlog.bbs and userlog.inx for
  72. maximum speed and efficiency.  It allows the user to pull up all users of
  73. the bbs that contain a given search string.
  74.  
  75.    Advanced user search can be used as a straight User List to list all
  76. users in alphabetical order, a search utility or a Mail Front end from
  77. which a user may execute a search and choose from a list of matches to
  78. start an E-mail message.  This makes searching easy on your users.
  79.  
  80.  
  81. ==========================================================================
  82.                                REQUIREMENTS
  83. ==========================================================================
  84. TBBS
  85. TDBS add on module
  86. Working knowledge of the menu.sdl
  87.  
  88. ==========================================================================
  89.                                  Setup
  90. ==========================================================================
  91.  
  92.   Unarchive the files straight into your TBBS directory or, make a
  93. special directory to put the files.
  94.  
  95.   Edit ausearch.ini and make the necessary changes.
  96.   Line 1 should be the path to your userlog.bbs file.
  97.   Line 2 should be the path to your userlog.inx file.
  98.  
  99.   This may seem strange, but our particular setup has these two files on
  100. two different drives, so I figured others may have the same needs.  Include
  101. the full path, this means the filename as well.
  102.  
  103.   e.g. C:\TBBS\USERLOG.BBS
  104.  
  105.   Line 3 should be the name of the BBS (Used for registration code)
  106.   Line 4 should be the name of the Sysop (Used for registration code)
  107.   Line 5 should be your registration code
  108.  
  109.    If you do not have a registration code, your users will see a copyright
  110. message at the end of each search with an extra Press Any Key Prompt.  When
  111. you register, your name and BBS name as specified will show up as the
  112. registered owner.
  113.  
  114.    There, external setup is done.  Now all that is left is to add an
  115. entry in the menu.sdl file.  Each of the following examples assumes that
  116. your have installed AUSEARCH to your TBBS directory on drive C, modify
  117. the path to fit your needs.  Also substitute the '*' in each example with
  118. the key that you would like start AUSEARCH
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         1
  127.  
  128.  
  129.  
  130. Add AUSEARCH as a User List
  131. ===========================
  132.  
  133. Entry:
  134. KEY=* TYPE=200 OPT DATA=C:\TBBS\AUSEARCH.TPG /Q
  135.  
  136.    This entry will simply list alphabetically all users on the bbs, and
  137. their location field.  Most sysops will probably prefer the next example.
  138.  
  139.  
  140. Add AUSEARCH as a User Search/List Utility
  141. ==========================================
  142.  
  143. Entry:
  144. KEY=* TYPE=200 OPT DATA=C:\TBBS\AUSEARCH.TPG -S /Q
  145.  
  146.     This entry will allow the user to type in a search string.  If the
  147. user does not provide a search string, AUSEARCH will list all users
  148. alphabetically.  Otherwise AUSEARCH will list all users who contain the
  149. search string in them.  To search for a last name, simply append a space
  150. before the search text, then any matched text will have to begin with a
  151. space.
  152.  
  153. Add AUSEARCH as a Mail Front End
  154. ================================
  155.  
  156. Entry:
  157. KEY=* TYPE=200 OPT DATA=C:\TBBS\AUSEARCH.TPG /Q && -MLOCAL
  158.  
  159. NOTE: the -M switch must appear as the last option on the line.
  160.  
  161.     This entry is to use AUSEARCH as a mail front end.  Replace LOCAL
  162. with the message area that the new message is to be posted to.  This will
  163. provide your users the ability to search when they are entering messages.
  164. Not only does it allow them to search, but if they find the user they want,
  165. they can simply type the number assigned to that user to start a new
  166. message.  This cuts down on the work your users have to do.
  167.  
  168. Note: If you do not supply a message area after the -M switch, TBBS will
  169.       supply the user with a list of TOPIC BOARDS to post in.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.                                                                         2
  190.  
  191.  
  192. =========================================================================
  193.                               REGISTRATION
  194. =========================================================================
  195.  
  196.    Registration is only $15 for online registration with a credit card,
  197. or $12 for a check or money order.
  198.  
  199.    If you wish to register online, you can call Pacifier Online Data
  200. Service at 1(360)693-0325 or telnet to pods.pacifier.com, and log on to
  201. the BBS as DOOREG.  From there you can demo/download/and register any of
  202. our TDBS applications.
  203.  
  204.    You can also download our applications from our web site.
  205. http://www.pacifier.com/~mark
  206.  
  207.    If you prefer to send a check or money order, make it out to Mark
  208. Jacobson for $12 and send it to this address:
  209.  
  210. (Print and fill out the order form that came with this package
  211.  REGISTER.FRM and send it with your payment.)
  212.  
  213.   1800 F. St.
  214.   Vancouver, WA  98663
  215.                
  216.     If you have any questions, suggestions, or customization needs you can
  217. contact me e-mail at mark@pacifier.com.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.                                                                         3
  253.